This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@cloudflare/nimbus-docs@0.14.0

Minor Changes

• #129 3fd7d15 Thanks @MohamedH1998! - Add a versioned breaking-change manifest, explicit reviewed upgrade baselines, agent-readable migration plans, shared check and outdated diagnostics, safe starter drift updates, starter agent upgrade guidance, and automatic migration guidance during Astro configuration.

• #142 5343933 Thanks @MohamedH1998! - Breaking: API coordinate manifests now use the compact v2 format exclusively.
  The existing getCoordinatesManifest() helper emits it by default; the endpoint,
  citation syntax, page URLs and anchors are unchanged. Repeated page URLs are stored
  once per namespace in a single JSON file. There is no additional helper or setting.

  Upgrade publishers and consuming sites together, rebuild publishers, and refresh
  checked-in manifests before rebuilding consumers. Old readers cannot consume v2,
  and new readers no longer consume v1. Stage both sides before switching live sites
  if uninterrupted citations are required. Local v1 references fail with rebuild
  guidance; remote v1 references warn and are skipped.

  Custom CoordinatesManifest readers must use collection pages and versions
  page groups instead of the old flat entries. Each group has a literal url and
  coordinate-keyed fragments: null means no fragment, 0 means the coordinate
  itself, and a string is the exact fragment. Do not relabel old JSON as v2.

  The linked upgrade-manifest entry includes rollout, verification and rollback
  guidance. This changes citation transport, not Astro's content store or SSR behavior.

• #139 ea8cd46 Thanks @MohamedH1998! - Render MDX admonitions with Sätteri's native directive parser, preserving nested
  content, code examples, plain titles, aliases, and scoped opt-outs. Use
  markdown.mdastPlugins and markdown.hastPlugins for native extensions.
  Explicit incompatible processors must disable Nimbus admonitions, while Astro
  MDX options continue to pass through unchanged. Native admonitions now apply to
  .mdx only; review existing admonition directives in .md files. Astro 7.2.6
  or newer is required.

Patch Changes

• #122 4b51ebb Thanks @MohamedH1998! - Allow user-owned Astro pages and scaffolded Markdown and llms.txt endpoints to use native rendering semantics while retaining entrypoint-aware checks for active Nimbus contracts and composing with unrelated integration routes. These dynamic endpoints now resolve their payloads when rendered on request. Endpoint helpers now live at @cloudflare/nimbus-docs/agent-endpoints; the existing @cloudflare/nimbus-docs/publication entrypoint remains supported. Sub-path sitemaps now list the deployment root once.

• #138 3f7c16a Thanks @MohamedH1998! - Preserve authored root-relative links and unrelated source across Markdown and
  MDX, including HTML containers, fenced examples, Unicode, and CRLF. Keep plain
  Markdown unchanged when generating Markdown and agent endpoint output.

• #137 728e753 Thanks @MohamedH1998! - Update generated projects to Astro 7.2.8 and align the Node adapter with Astro's updated runtime API.

@cloudflare/create-nimbus-docs@0.7.4

Patch Changes

• #129 3fd7d15 Thanks @MohamedH1998! - Add a versioned breaking-change manifest, explicit reviewed upgrade baselines, agent-readable migration plans, shared check and outdated diagnostics, safe starter drift updates, starter agent upgrade guidance, and automatic migration guidance during Astro configuration.

• #122 4b51ebb Thanks @MohamedH1998! - Allow user-owned Astro pages and scaffolded Markdown and llms.txt endpoints to use native rendering semantics while retaining entrypoint-aware checks for active Nimbus contracts and composing with unrelated integration routes. These dynamic endpoints now resolve their payloads when rendered on request. Endpoint helpers now live at @cloudflare/nimbus-docs/agent-endpoints; the existing @cloudflare/nimbus-docs/publication entrypoint remains supported. Sub-path sitemaps now list the deployment root once.

• #141 7790b7c Thanks @MohamedH1998! - Reduce repeated API field-icon markup by sharing SVG paint settings in the existing field-list stylesheet. Preserve icon shapes, field content, links, and disclosure behavior. Existing sites can apply the owned component and stylesheet changes together; framework upgrades do not overwrite owned files.

• #139 ea8cd46 Thanks @MohamedH1998! - Render MDX admonitions with Sätteri's native directive parser, preserving nested
  content, code examples, plain titles, aliases, and scoped opt-outs. Use
  markdown.mdastPlugins and markdown.hastPlugins for native extensions.
  Explicit incompatible processors must disable Nimbus admonitions, while Astro
  MDX options continue to pass through unchanged. Native admonitions now apply to
  .mdx only; review existing admonition directives in .md files. Astro 7.2.6
  or newer is required.

• #137 728e753 Thanks @MohamedH1998! - Update generated projects to Astro 7.2.8 and align the Node adapter with Astro's updated runtime API.

• #140 a6ccf99 Thanks @MohamedH1998! - Reserve the desktop API code-rail column before streamed rail HTML arrives, preventing the main content from shifting sideways. Preserve mobile stacking, no-rail layouts, and custom rail width. Existing sites can copy the updated owned ApiLayout component if desired; updating the framework does not overwrite it. This prevents layout shift without making the rail arrive sooner.

• Updated dependencies [3fd7d15, 4b51ebb, 5343933, 3f7c16a, ea8cd46, 728e753]:

  • @cloudflare/nimbus-docs@0.14.0